Inside Macintosh: Telephony /

Chapter 1 - Introduction to Telephony on the Macintosh / Telephone Manager Initialization Reference

Constants

Tool Choosing Result Codes

The TELChoose function can return certain result codes in addition to the normal Telephone Manager result codes. These additional result codes are defined by constants (some of which are themselves defined using constants defined by the Communications Toolbox).

enum {
   telChooseDisaster       = chooseDisaster,
   telChooseFailed         = chooseFailed,
   telChooseAborted        = chooseAborted,
   telChooseOKMinor        = chooseOKMinor,
   telChooseOKMajor        = chooseOKMajor,
   telChooseCancel         = chooseCancel,
   telChooseOKTermChanged  = 4
};

Constant descriptions

telChooseDisaster

The function failed because the specified telephone tool could not be located in the Extensions folder. As a result, the telephone record specified by the hTEL parameter has been disposed of and nil is returned in place of the telephone record handle.

telChooseFailed

An attempt to choose a telephone tool or change the settings has failed, and the telephone record specified by the hTEL parameter is unchanged.

telChooseAborted

An attempt was made to change the tool settings before the telephone tool was closed.

telChooseOKMinor

The user clicked OK in the dialog box but did not change the telephone tool. The tool's settings might or might not have changed. The hTEL parameter is unchanged, but the associated telephone record might have been updated.

telChooseOKMajor

The user selected a new telephone tool and clicked OK in the dialog box. The Telephone Manager destroys the telephone record passed in, creates and configures a new telephone record, and returns a handle to that new record in the hTEL parameter.

telChooseCancel

The configuration of a telephone tool was canceled. The telephone record specified by the hTEL parameter is unchanged.

telChooseOKTermChanged

The terminal reference number has changed because the user selected a new tool or changed the settings of the current tool.